Skip to content

human documenation - #574

Merged
jonathanong merged 12 commits into
mainfrom
jonathanong-patch-1
Aug 23, 2026
Merged

human documenation#574
jonathanong merged 12 commits into
mainfrom
jonathanong-patch-1

Conversation

@jonathanong

@jonathanong jonathanong commented Jul 21, 2026

Copy link
Copy Markdown
Owner
  • add an example for passing in a diff for test selection
  • add performance metrics
  • add feature support matrix

Shepherd Journal

  • codecov/project/rust "No coverage information found on head" is follow-on while Rust coverage is still running; no code change.
  • add worktrees and bullmq to cspell so README lint passes.

Expanded the README to include a detailed explanation of the 'no-mistakes' tool, its advantages, and trade-offs related to AST-parsing.
@chatgpt-codex-connector

This comment has been minimized.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jul 21, 2026
@sourcery-ai

This comment has been minimized.

@coderabbitai

This comment has been minimized.

sourcery-ai[bot]

This comment was marked as resolved.

coderabbitai[bot]
coderabbitai Bot previously requested changes Jul 21, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Line 32: Update the no-mistakes description to avoid guaranteeing that
relationships are never missed: present high recall as an aspiration or advise
agents to verify important relationships, while preserving the existing warning
about potentially incorrect relationships.
- Line 31: Correct the misspelled word “understnad” to “understand” in the
README sentence describing AST parsing, leaving the rest of the text unchanged.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fd0e2ec3-3886-487b-8cea-9cca482ba8aa

📥 Commits

Reviewing files that changed from the base of the PR and between 2a8c701 and e3b455f.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md Outdated
Comment thread README.md Outdated
Updated README to improve clarity and fix typos.
@codspeed-hq

This comment has been minimized.

coderabbitai[bot]
coderabbitai Bot previously requested changes Jul 21, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (1)
README.md (1)

143-144: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Keep a local link-check path for contributors.

CI still runs Lychee over README.md and documentation files in .github/workflows/ci.yml; removing the only README instructions leaves contributors without a documented way to reproduce that check locally. Retain a short command or link to the CI check.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` around lines 143 - 144, Restore a concise README section
documenting how contributors can run the same Lychee link check locally, or link
to the corresponding workflow in `.github/workflows/ci.yml`; keep the
instructions aligned with the CI check covering README.md and documentation
files.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Line 21: Update the README sentence beginning “The primary use-cases of
`no-mistakes`” to use “are” instead of “is,” preserving the rest of the wording.
- Line 33: In the README text, correct the misspelled word “determinstically” to
“deterministically” while leaving the surrounding statement unchanged.
- Around line 21-25: Add a concrete diff-input command to the README’s primary
use-cases or test-selection documentation, alongside the existing --changed-file
examples. Use the tool’s supported diff argument and show a representative diff
source so users can see how to select tests from changes.

---

Nitpick comments:
In `@README.md`:
- Around line 143-144: Restore a concise README section documenting how
contributors can run the same Lychee link check locally, or link to the
corresponding workflow in `.github/workflows/ci.yml`; keep the instructions
aligned with the CI check covering README.md and documentation files.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 92f5d183-6cfb-4856-9b74-4d7124442ab7

📥 Commits

Reviewing files that changed from the base of the PR and between e3b455f and dcd4029.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
@codecov

This comment has been minimized.

@jonathanong
jonathanong enabled auto-merge (squash) August 23, 2026 02:29
Keep the agent README, fix spelling, and retain current main docs such as the harness list.

Co-authored-by: Cursor <cursoragent@cursor.com>
@jonathanong
jonathanong dismissed stale reviews from coderabbitai[bot] and coderabbitai[bot] August 23, 2026 02:37

Addressed README merge: kept the agent Why section, fixed spelling, added --from-git-diff example, and retained main's harness ecosystem.

The human README uses both spellings, and cspell only had the singular worktree.

Co-authored-by: Cursor <cursoragent@cursor.com>
@jonathanong
jonathanong merged commit 7a518fb into main Aug 23, 2026
16 of 17 checks passed
@jonathanong
jonathanong deleted the jonathanong-patch-1 branch August 23, 2026 02:54
jonathanong added a commit that referenced this pull request Aug 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

configuration documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant